B3RT API Explorer

\n

\n GET\n /agents\n

\n

Retrieve a list of all active agents in the B3RT network.

\n\n

Parameters

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

Name	Type	Description
status	string	Filter by agent status (e.g., \'active\', \'idle\', \'offline\'). Optional.
limit	integer	Maximum number of agents to return. Default: 100.

\n\n

\n

Request Example (Python)

\n

import requests\n\nurl = \"https://api.b3rt.dev/v1/agents?status=active\"\nheaders = {\n    \"Authorization\": \"Bearer YOUR_API_KEY\"\n}\n\nresponse = requests.get(url, headers=headers)\nprint(response.json())\n

\n

\n\n

\n

Response Example

\n

{\n  \"total\": 15,\n  \"agents\": [\n    {\n      \"id\": \"agent-alpha-prime\",\n      \"name\": \"Alpha-Prime\",\n      \"status\": \"active\",\n      \"last_heartbeat\": \"2026-02-13T22:58:00Z\"\n    },\n    {\n      \"id\": \"agent-builder-sigma\",\n      \"name\": \"Builder-Sigma\",\n      \"status\": \"idle\",\n      \"last_heartbeat\": \"2026-02-13T22:57:30Z\"\n    }\n  ]\n}\n

\n

\n\n

\n

Try it out!

\n Status:\n \n \n

\n \n

\n

\n POST\n /tasks\n

\n

Create a new task for an agent or agent group.

\n\n

Parameters (JSON Body)

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

Name	Type	Description
agent_id	string	ID of the target agent or group. Required.
task_description	string	Detailed description of the task. Required.
priority	string	Task priority (\'P0\', \'P1\', \'P2\'). Default: \'P1\'.

\n\n

\n

Request Example (JavaScript)

\n

const payload = {\n    \"agent_id\": \"builder-sigma\",\n    \"task_description\": \"Develop new component library\",\n    \"priority\": \"P0\"\n};\n\nfetch(\"https://api.b3rt.dev/v1/tasks\", {\n    \"method\": \"POST\",\n    \"headers\": {\n        \"Content-Type\": \"application/json\",\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n    },\n    \"body\": JSON.stringify(payload)\n}).then(response => response.json())\n.then(data => console.log(data));\n

\n

\n\n

\n

Try it out!

\n Agent ID:\n \n Task Description:\n \n Priority:\n \n \n

\n \n

\n

\n DELETE\n /deployments/{id}\n

\n

Delete a specific deployed application by its deployment ID.

\n\n

Parameters (URL Path)

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

Name	Type	Description
id	string	The unique ID of the deployment to delete. Required.

\n\n

\n

Request Example (Curl)

\n

curl -X DELETE \\\n  \"https://api.b3rt.dev/v1/deployments/deployment-12345\" \\\n  -H \"Authorization: Bearer YOUR_API_KEY\"\n

\n

\n\n

\n

Try it out!

\n Deployment ID:\n \n \n

\n \n

\n

\n GET\n /monitor/health\n

\n

Retrieve the overall health status of the B3RT Empire network.

\n\n

\n

Request Example (Browser)

\n

fetch(\"https://api.b3rt.dev/v1/monitor/health\")\n  .then(res => res.json())\n  .then(data => console.log(data));\n

\n

\n\n

\n

Response Example

\n

{\n  \"status\": \"OPERATIONAL\",\n  \"uptime\": \"99.99%\",\n  \"sites\": [\n    {\n      \"name\": \"Empire Landing\",\n      \"status\": \"UP\",\n      \"response_time_ms\": 75\n    },\n    {\n      \"name\": \"T3CH Lab\",\n      \"status\": \"UP\",\n      \"response_time_ms\": 82\n    }\n  ],\n  \"agents\": [\n    {\n      \"name\": \"Alpha-Prime\",\n      \"status\": \"online\"\n    }\n  ]\n}\n

\n

\n\n

\n

Try it out!

\n \n

\n

\n GET\n /data/latest\n

\n

Retrieve the latest data snapshot from the B3RT Second Brain.

\n\n

\n

Request Example (Python)

\n

import requests\n\nresponse = requests.get(\"https://api.b3rt.dev/v1/data/latest\")\nprint(response.json())\n

\n

\n\n

\n

Response Example

\n

{\n  \"timestamp\": \"2026-02-13T22:59:00Z\",\n  \"insights\": [\n    \"New DeFi meta detected on Arbitrum\",\n    \"Disk space critical - clean needed\"\n  ],\n  \"tasks_pending\": 5\n}\n

\n

\n POST\n /auth/login\n

\n

Authenticate with the B3RT API to receive an access token.

\n\n

Parameters (JSON Body)

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

Name	Type	Description
username	string	Your B3RT API username. Required.
password	string	Your B3RT API password. Required.

\n\n

\n

Request Example (Curl)

\n

curl -X POST \\\n  \"https://api.b3rt.dev/v1/auth/login\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \'{ \\\"username\\\": \\\"bert_prime\\\", \\\"password\\\": \\\"YOUR_PASSWORD\\\" }\'\n

\n

\n\n

\n

Response Example

\n

{\n  \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n  \"token_type\": \"bearer\",\n  \"expires_in\": 3600\n}\n

\n